Administrator Guide 2017
Import a job sheet
Before you start
This option imports data from a spreadsheet and places it in the job queue
  1. Is this an effective way of operating? All jobs in a spreadsheet are imported for the specified customer and location, regardless of any customer names on the list.  If you do not receive bulk orders from a single customer for a single location this may not be the best way to do this.
  2. Do you have existing job data spreadheet(s)?  Identify and open these before you start.
  3. Are different spreadsheets to be imported to the same job definition?  These steps guide you through using just one, but more than be used either by creating a list entry for each or by using the same format for both (ie the same order of columns).  Different job definitions can be selected during the import process.
  4. Do you have more than one job for each customer/location? The customer and location are specified during import, so if each customer location has only one job this is not the most efficient way of operating.
Why would I import an Excel spreadsheet of job data?
  1. Because a particular customer sends a list of jobs for a particular site in this format and it is preferrable to re-entering by hand.
  2. Because simple data entry may lend itself to row by row entry for single (or few) customer locations.  These would need to be separated into customer location specific spreadsheets.
  3. Because staff logging service calls do not have access to magic5.
  4. Because job data is repetitive and can be pasted into the spreadsheet to prevent duplicating data entry.  Please note that this may also be resolved with careful job definition set up.
Overview of process
  1. Step 1. Open the original Excel spreadsheet
  2. Step 2. Create a job definition into which the job data will be imported
  3. Step 3. Create a list called 'Spreadsheet formats (Jobs)'
  4. Step 4. Create entries in this list
  5. Step 5. Import the job data from the spreadsheet
Step 1. Open the original Excel spreadsheet
  1. Open your Excel spreadsheet which might look something like this:

           
  2. If you do not currently have a spreadsheet please read through this guide before creating one so that you can optimise the design.
Step 2. Create a job definition into which the job data will be imported
  1. Create a suitably named job definition (ie better than mine!) with an appropriate associated template (get help).
  2. Add items (get help) that correlate with the data columns that will be imported from your spreadsheet.  For example, the job definition below will receive data from the spreadsheet shown in step 1. Job data such as date, customer and location are automatically included in the job definition.

  3. Further items and actions not related to the spreadsheet can be added as required.
  4. Make a note of the unique names relating to the import data (or leave this screen open for reference).
Step 3. Create a list called 'Spreadsheet formats (Jobs)'
  1. Create a list (get help) with the title Spreadsheet formats (Jobs). The exact name is important.
  2. In the 'Additional Attributes for list entries' tab, tick the boxes illustrated below.

  3. Save.
Step 4. Create entries in the list
  1. Add a list entry (get help) for each spreadsheet format you will be using (making the title more meaningful than mine!).
  2. Open the Additional Attributes tab.
  3. In Number of header lines to ignore, enter the number of rows on the spreadsheet that do not have data that you wish to import (eg logo, company address, headings).
  4. In Spreadsheet columns unique names enter the corresponding unique names from the job definition. 

    If there are columns in the spreadsheet that you do not wish to appear in the job details, prefix them with a hyphen ('-') and enter any name (it is recommended to use something meaningful for future reference).  These must be included as 'placeholders' so that subsequent data items appear in the correct place.
  5. In Primary key specifications enter the name (as in step 4) of the column that holds a unique identifier for each row (such as Job Number).  If more than one list entry is being created (ie there is more than one import format) it is recommended that this is prefixed with some text (eg the name of the format) to maintain uniqueness between imports (for example, using my not-very-meaningful-name, 'Format 1_%@jobJobNo%' (without quotes)).
  6. Tick the Import unallocated jobs box avoid losing any jobs while getting underway.  It can be changed at a later date.
  7. In User key specifications enter the name of the column in the spreadsheet where the user (or operative) is stored.
  8. In Date key specifications enter the name of the column in the spreadsheet where the date is stored.
  9. Save.

Step 5. Import the job data from the spreadsheet
  1. Open the jobs list (unallocated or outstanding) and click the Import jobs from spreadsheet button.
  2. Click the Add attachment link to select the required spreadsheet from your local folders.
  3. Select the required Spreadsheet format from the drop-down list.  This will be the one(s) created in step 4.
  4. Select the associated Job type (as created in step 2).
  5. Select the associated Template.  This should be the same as the Associated template selected in the Job definition.
  6. Select the Customer and Location for whom you are importing job data (the location will be populated once the customer has been selected).
  7. Save to start the import.
  8. When the screen has refreshed (indicated by your browser 'wait' icon) you should see the new items in your job list.  It is recommended that you check these until you are confident that the import is set up correctly as incorrect set up may appear to work but omit rows (for example, if the number of rows to ignore is incorrect).

See Also